home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / gcc / info2guide_3.lha / info2guide / Original.Doc < prev   
Encoding:
Text File  |  1993-12-23  |  3.7 KB  |  89 lines
  1. Info2Guide
  2.  
  3.   This is a simple (full of bugs) ARexx program that can translate into Amiga-
  4. Guide format Info-files that comes within GCC packge (roundabout 22M).
  5.   These  files can  be found into GCC:info/ path , and can  be  read  with the
  6. file `InfoView' tha comes  with  the packge . The matter is that the viewer is
  7. quite  user-unfriendly  (you must take  control  via keyboard and commands are
  8. very very very ...).
  9.   Here this simple prog comes in. Let's suppose you wanna read something about
  10. `diff'; related files are (you must look into GCC:info/):
  11.     - `diff.info'
  12.     - `diff.info-1'
  13.     - `diff.info-2'
  14.     - `diff.info-3'
  15.     - `diff.info-4'
  16.   Now you only have to invoke the "function" with parameter "diff" . Automati-
  17. cally it will process these files , and the result  will  be a unique big file
  18. containing proper nodes.
  19.  
  20.   Please note that some translation (from Info to AmigaGuide) doesn't fit: for
  21. example it cannot propely translate information if node declaration falls down
  22. between to different (but consecutive) lines (you may fix this editing manual-
  23. ly resulting text).
  24.  
  25.   Please note  that manipulating  very big files is quite inefficient : better
  26. achievement  would have been mantaining  separate files (note that  AmigaGuide
  27. do support this).
  28.  
  29.   Please note that initial intent of Info archive was to organize all informa-
  30. tions under the only index called `dir', but I've found hard to realize with a
  31. very light code (written in ARexx).
  32.  
  33.   Please  note that  I have no documentation that  describes how the `*.info*'
  34. files are structured and  organized (but if you have it , you can E-Mail it to
  35. me: I'll like).
  36.  
  37.   Let me know if you are intrested about the idea: my E-Mail address is
  38. Alessandro Ponzio
  39. istrice@paola.dei.unipd.it
  40.  
  41. P.S.: If you really want a faster implementation, you can bring to me sugges-
  42.       tions about the GCC. For example:
  43.         -1- How can I make GCC to compile programs?
  44.             I've installed the full packge and nowI got version 2.5.7 of prog
  45.             but something doesn't match: nothing appens when I execute
  46.                 CLI> gcc Prova.c
  47.             HardDrive works, but no output can be find.
  48.             I've also tried with
  49.                 CLI> gcc -o RAM:exe Prova.c
  50.             but nothing can be find in RAM: too.
  51.  
  52.             My sistem configuration is:
  53.                 Amiga 1200 68EC020 14MHz, no FPU, 2Mb CHIP, AmigaOS 3.0
  54.                 Workbench 39.29 - Kickstart 39.106
  55.  
  56.         -2- How can I find ARexx compile? Are there some PD compiler?
  57.  
  58.  
  59. ------------------------------------------------------------------------------
  60.  
  61. History
  62.  
  63.       1.0     Very first implementation. ARexx was the language adopted. Never
  64.               released.
  65.  
  66.       1.1     A merely correction of previous version. Fixed bug that made
  67.               uncorrect translation of linked sub-nodes when they were not
  68.               preceded by `* ':this was achieved including `Strip' command
  69.               in the source. (Note that linked-nodes are recognised if and
  70.               only if they are successed by `::')
  71.  
  72. ------------------------------------------------------------------------------
  73.  
  74. Please note that I do not want assume any responsability about provided prog.
  75.                    ¯¯¯¯¯¯¯¯¯¯¯
  76. It is made only upon my exclusive conception, and it do not represend a tran-
  77. slation of some algorithm or program written in any other language.
  78.  
  79. P.S. I've included that because this is the very first time I release any prog
  80.      in PD . I'm sure that no one will seriously consider it , but I'm  afraid
  81.      about various misunderstanding.
  82.  
  83. Let me know if you are interested in ARexx programming (I'll also like to know
  84. your programming tecnique). If you use Internet my E-Mail is:
  85.    Alessandro Ponzio
  86.    istrice@paola.dei.unipd.it
  87.  
  88. C U Soon.
  89.